/*******************************************************************************
 * Copyright (c) 2009 David Harrison.
 * All rights reserved. This program and the accompanying materials
 * are made available under the terms of the GNU Public License v3.0
 * which accompanies this distribution, and is available at
 * http://www.gnu.org/licenses/gpl-3.0.html 
 *  
 * Contributors:
 *     David Harrison - initial API and implementation
 ******************************************************************************/
package com.sfs.postcodes.dao;

/**
 *
 * @author David Harrison
 */
public interface PostcodeDAO {
 
    /**
     * Takes an address formatted in the following manner
     * street,suburb,city,state,country and checks for a postcode
     * Intended to work for New Zealand and Australian addresses
     * @param address
     * @param state
     * @param country
     * @return
     * @throws com.sfs.postcodes.dao.PostcodeLookupException
     */
    public String findPostcode(final String address, final String state, 
            final String country) throws PostcodeLookupException;
    
}
